home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 28 / MACUSER-MACBIN28A-1996-03.ISO.7z / MACUSER-MACBIN28A-1996-03.ISO / Demo / MachTen 4.0.2 Demo / X Window Software / X11R5 / man / mann / ico.0 < prev    next >
Text File  |  1995-08-21  |  3KB  |  127 lines
  1. NAME
  2.        ico - animate an icosahedron or other polyhedron
  3.  
  4. SYNOPSIS
  5.        ico  [-display display] [-geometry geometry] [-r] [-d pat-
  6.        tern] [-i] [-dbl] [-faces]  [-noedges]  [-sleep  n]  [-obj
  7.        object] [-objhelp] [-colors color-list]
  8.  
  9. DESCRIPTION
  10.        Ico displays a wire-frame rotating polyhedron, with hidden
  11.        lines removed, or  a  solid-fill  polyhedron  with  hidden
  12.        faces  removed.  There are a number of different polyhedra
  13.        available; adding a new polyhedron to the program is quite
  14.        simple.
  15.  
  16. OPTIONS
  17.        -r     Display  on  the  root window instead of creating a
  18.               new window.
  19.  
  20.        -d pattern
  21.               Specify a bit pattern for drawing dashed lines  for
  22.               wire frames.
  23.  
  24.        -i     Use inverted colors for wire frames.
  25.  
  26.        -dbl   Use  double  buffering  on the display.  This works
  27.               for either wire frame or solid fill drawings.   For
  28.               solid  fill  drawings, using this switch results in
  29.               substantially smoother movement.   Note  that  this
  30.               requires twice as many bit planes as without double
  31.               buffering.  Since some colors are  typically  allo-
  32.               cated  by other programs, most eight-bit-plane dis-
  33.               plays will probably be limited to eight colors when
  34.               using double buffering.
  35.  
  36.        -faces Draw filled faces instead of wire frames.
  37.  
  38.        -noedges
  39.               Don't  draw  the  wire frames.  Typically used only
  40.               when -faces is used.
  41.  
  42.        -sleep n
  43.               Sleep n seconds between each move of the object.
  44.  
  45.        -obj object
  46.               Specify what object to draw.  If no object is spec-
  47.               ified, an icosahedron is drawn.
  48.  
  49.        -objhelp
  50.               Print  out  a  list of the available objects, along
  51.               with information about each object.
  52.  
  53.        -colors color color ...
  54.               Specify what colors should  be  used  to  draw  the
  55.               filled  faces  of  the object.  If less colors than
  56.               faces are given, the colors are reused.
  57.  
  58. ADDING POLYHEDRA
  59.        If you have the source to ico, it is very easy to add more
  60.        polyhedra.   Each polyhedron is defined in an include file
  61.        by the name of objXXX.h, where XXX is something related to
  62.        the  name  of  the  polyhedron.  The format of the include
  63.        file is defined in the file polyinfo.h.  Look at the  file
  64.        objcube.h to see what the exact format of an objXXX.h file
  65.        should be, then create your objXXX.h file in that  format.
  66.  
  67.        After  making  the  new objXXX.h file (or copying in a new
  68.        one from elsewhere), simply do a 'make depend'.  This will
  69.        recreate  the  file  allobjs.h,  which  lists  all  of the
  70.        objXXX.h files.  Doing a 'make' after  this  will  rebuild
  71.        ico with the new object information.
  72.  
  73. SEE ALSO
  74.        X(1)
  75.  
  76. BUGS
  77.        Pyramids and tetrahedrons with filled faces do not display
  78.        correctly.
  79.  
  80.        A separate color cell is allocated for each  name  in  the
  81.        -colors  list,  even  when  the same name may be specified
  82.        twice.
  83.  
  84. COPYRIGHT
  85.        Copyright 1988, Massachusetts Institute of Technology.
  86.        See X(1) for a full statement of rights and permissions.
  87.  
  88. X Version 11                Release 5                           2
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.